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Notational Conventions 


THIS TYPE Use these keywords, letters, symbols, 
and punctuation verbatim. Upper or 
lowercase is acceptable. 


italics Substitute language elements or 
constructs for true terms. 

{ ] Optional constructs. 

fl ike Optional constructs that can be repeated 


any number of times. 


Led The preceding item may be repeated, 
but each repetition must be separated 
by a comma. 


ob Alternate constructs. Choose any one 
of the constructs enclosed in the 
braces. 


/*text enclosed*/ Text enclosed is a prose definition of the 
construct. 


When two adjacent items must be concatenated, they 
appear with no space between them. A blank space 
between two items indicates that the two items may be 
separated by one or more blanks. 


Definitions of Common Terms 


Names can be from 1 to 40 characters long 
and must be composed of letters (A-Z), 
digits (0-9), or special characters (?, @, -). 
The first character must be a letter or a 
special character. 


Same as name. 


module-name 


segment-name Same as name. 
pathname A valid filename reference or device refer- 
ence. See next two items for examples. 
filename A reference to a disk file. The format is: 
root [.ext] 
device A reference to a non-disk device. 
Examples: :LP:, :CO:, :TO:. 
value A 16-bit unsigned integer. 
Examples: 1011B, 304Q, 4096D (or just 
4096), OC300H. 


address Same as value 


RL51 Command Format Summary 


[directory | device} RLS51 input-list [10 output-file| [(control-list} 
where 


[directory | device] 
is the directory or device where RL51 resides. 


input-list : = 
input-file [module-list][,...] 


input-file : = 
filename 


RL51 Command Format Summary (Cont’d.) 


module-list : = 
( module-name [,...]) 


output-file : = 
filename 


control-list : = 
control ... 


control ; = 
listing-control 
linking-control 
locating-control 
configuration-control 
overlay-control 


listing-control : = 
print 
pagewidth 
map 
symbols 
publics 
lines 
ixref 


print :* 
PRINT [( pathname) | 
NOPRINT 


pagewidth :* 
PAGEWIDTH( value) 


map :* 
MAP 
NOMAP 

symbols : = 


SYMBOLS 
NOSYMBOLS 
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publics ;= 


eae 
NOPUBLICS 


lines :* 
LINES 
NOLINES 


ixref : = 


1X REF [selection-list| 
NOIXREF 


selection-list : = 
(selection-item |...) 


selection-item : = 


generated 
libraries 


generated : = 


GENERATED | 
NOGENERATED 


libraries: = 


Were 
NOLIBRARIES 


linking-control_ : = 
NAME ( module-name) 
debugsymbols 
debuglines 
debugpublics 


debugsymbols_ : = 


DEBUGSYMBOLS 
NODEBUGSYMBOLS 
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debuglines : = 


DEBUGLINES 
NODEBUGLINES 


debugpublics : = 


DEBUGPUBLICS 
NODEBUGPUBLICS 


locating-control : = 


PRECEDE 

DATA 

BIT 

IDATA (segment |....]) 
STACK 

XDATA 

CODE 


segment := 
segment-name_ | (address) | 


configuration-control: = 
ramsize 


ramsize : = ‘ 
RAMS 1ZE (value) 


overlay-control : = 


OVERLAY[( Overlay-unit [,...])] 
NOOVERLAY 


overlay-unit : + 
ov-module-name calls ov-module-name 


Ov-module-name_: = 


{ module-name \ 


calls :* 
> or] 


Listing Controls 


PRINT [(pathname)] 


NOPRINT 
PAGEWIDTH (value) 


MAP 
NOMAP 
SYMBOLS 
NOSYMBOLS 
PUBLICS 
NOPUBLICS 
LINES 


NOLINES 
IXREF [(selection-list)} 


NOIXREF 


Sends the listing file to the file or device 
specified by pathname 


Suppresses the listing file; overrides any 
of the following listing controls. 


Specifies the maximum page width to be 
used. 


Outputs memory map to link summary. 
Suppresses memory map. 

Outputs local symbols to symbol table. 
Suppresses local symbols. 

Outputs public symbols to symbol table 
Suppresses public symbols. 


Outputs line numbers to symbol table 
(high-level language translators only). 


Suppresses line numbers. 


Appends intermodule cross-reference 
report to print file. 


Suppresses the intermodule cross- 
reference report 


NOTE: The default for any control (except IXREF) is the positive form 
(PRINT, MAP, SYMBOLS, PUBLICS, and LINES) 


Linking Controls 


Control Effect 


NAME (module-name) Specifies the name of the output . 
module. If the NAME control is omitted, 
the output module name defaults to the 
name of the first input module 


processed 


DEBUGSYMBOLS Copies local symbol information to 
output file. 
NODEBUGSYMBOLS Suppresses local symbols. 


DEBUGPUBLICS Copies public symbol information to 


output file 
NODEBUGPUBLICS 
DEBUGLINES 


Suppresses public symbols 


Copies line number information (high- 
level language translators only) to output 
file. 


NODEBUGLINES Suppresses line numbers. 


NOTE: For ail linking controls except NAME, the default is the positive 
form (DEBUGSYMBOLS, DEBUGPUBLICS, and DEBUGLINES). 


Locating Controls 


Address 
Control Address Space Range 
(Hex) 


Segment Types 
(and Attributes) 


PRECEDE Register banks and bit- | OOH-2FH DATA (UNIT-aligned); 
addressable space in IDATA 
on-chip data RAM 


Bit-addressable space | OOH-7FH BIT; DATA: IDATA 
in on-chip data RAM (see note 1) 


Oirectily-addressable OOH-7FH DATA (UNIT-aligned); 
on-chip data RAM IDATA 


Indirectly-addressable OOH-OFFH IDATA 
on-chip data RAM (see note 2) 


Same as IDATA (see | Same as Same as IDATA 
note 3) IDATA 


External data RAM 0-OFFFFH XDATA 
Code memory 0-OFFFFH CODE 


Notes on Locating Controls 


It, 


Bit addresses for non-BIT segments in the BIT control 
must be on byte boundaries; that is, they must be 
divisible by 8. (BIT-type segments can be aligned on 
bit boundaries.) 

The range of addresses for the IDATA control is depend- 
ent on the target machine. The 8051 has 128 bytes 
(addresses OOH-7FH). See the RAMSIZE control in this 
context. 

The STACK control specifies which segments are to be 
allocated uppermost in the IDATA space. The memory 
accessed starts after the highest on-chip RAM address 
occupied by any previously allocated segment, and contin- 
ues to the top of the IDATA space, 


NOTE 
This control has no other effect on any 
segments. 
The IDATA ?STACK segment, if it exists, is 


placed higher than segments that are 
mentioned in the STACK control. 


Overlaying Controls 


OVERLAY (overlay-units) Overlays data segments, based on the 
information in the module declarations 


and in the overlay units. 


NOOVERLAY Suppresses the overlaying of data 
segments. 


Configuration Controls 


[> = i 


RAMSIZE (value) Specifies the maximum amount of on-chip 
RAM that may be allocated for the user 
program. 


Abbreviations for Command Words 


Command Word Abbreviation 


BIT BI 
CODE co 
DATA DT 
DEBUGLINES DL 
DEBUGPUBLICS DP 
DEBUGSYMBOLS DS 
GENERATED GN 
IDATA 1D 
IXREF IX 
LIBRARIES LB 
LINES Li 
MAP MA 
NAME NA 
NODEBUGLINES NODL 
NODEBUGPUBLICS NODP 
NODEBUGSYMBOLS NODS 
NOGENERATED NOGN 
NOIXREF NOIX 
NOLIBRARIES NOLB 
NOLINES NOLI 
NOMAP NOMA 
NOOVERLAY NOOL 
NOPRINT NOPR 
NOPUBLICS NOPL 
NOSYMBOLS NOSB 
OVERLAY OL 
PAGEWIDTH PW 
PRECEDE PC 
PRINT 

PUBLICS 

RAMSIZE 

STACK 

SYMBOLS 

TO 

XDATA 


LIB51 Command Summary 


Following is a summary of the commands used by the 
LIBS1 librarian. 


Abbi 
abt mc] com | 
ion 
Adds modules to a hbrary 
Creates a library hile 


Deletes modules trom a 
library 
x 


ADD { file [module |... )]> [... | TO tbrary_ tiie 


CREATE library fle 


DELETE tiprary. tile (moduie (...]) 


EXTRACT { file [(module |...)}} [. 


Terminates session with 
L651 


Extracts modules trom 
libranes. 


ITO He 


Displays syntax of LIBS! 
commands 


UST { file ((moduie [...))]} [.. 1 [TO fle | PUBLICS} Lists modules contained in 


libraries and optionally lists 
ali publics 


REPLACE ( file [(module |. 


baa Replaces modules in a 


tprary 


JIN dbvary_tite 
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